home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / apidev / glide1.exe / DISK1.EXE / GLIDE.DOC < prev    next >
Text File  |  1993-08-01  |  24KB  |  554 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                     'The Glide'                               
  14.                                                                        
  15.                                  Generic  Language
  16.                   
  17.                         Integrated Developement Environment
  18.  
  19.                                  Version # 1.00.02
  20.                                                                          
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                       (c) Copyright 1993, Russell A. Powell                                                                                     
  42.                                                                        
  43.                                 All Rights Reserved.                                                                                               
  44.  
  45.                              Revision date: August 1993
  46.  
  47. DISCLAIMER OF WARRANTY
  48. ----------------------
  49. USERS OF THE GLIDE MUST ACCEPT THIS DISCLAIMER OF WARRANTY: THIS
  50. SOFTWARE AND DOCUMENTATION ARE PROVIDED AS IS WITHOUT ANY WARRANTIES AS
  51. TO PERFORMANCE, MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER
  52. EXPRESSED OR IMPLIED.  BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE
  53. ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS
  54. FOR A PARTICULAR PURPOSE IS OFFERED.  GOOD DATA PROCESSING PROCEDURE
  55. DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED WITH NON-CRITICAL DATA
  56. BEFORE RELYING ON IT.  THE USER MUST ASSUME THE ENTIRE RISK OF USING THE
  57. PROGRAM.  ANY LIABILITY OF THE AUTHOR/SELLOR WILL BE LIMITED EXCLUSIVELY
  58. TO PRODUCT REPLACEMENT OR REFUND OF THE PURCHASE PRICE.
  59.  
  60. IF YOU DO NOT ACCEPT THE ABOVE STATEMENTS, DELETE 'THE GLIDE' AND ALL
  61. OF ITS ASSOCIATED FILES NOW !!
  62.  
  63. LICENSE AGREEMENT
  64. -----------------
  65.  'The Glide' IS NOT FREE !! The Glide is a user-supported "shareware
  66.  program". You may use 'The Glide' for 30 days free of charge for the
  67.  purpose of evaluating it to see if it meets your needs. If after 30 days
  68.  you continue to use 'The Glide', YOU MUST REGISTER YOUR COPY.  Feel free
  69.  to share it with your friends, but please do not give it away altered or
  70.  as part of another system.  The essence of "user-supported" software is
  71.  to provide personal computer users with quality software without high
  72.  prices, and yet to provide incentive for programmers to continue to
  73.  develop new products.
  74.  
  75.  If you find this program useful and find that you are using 'The Glide'
  76.  and continue to use 'The Glide' after the 30 day trial period, you
  77.  must make a registration payment of $49 to the author at the address
  78.  listed below.  The $49 registration fee will license one copy for use on
  79.  any one computer at any one time.  You must treat this software just
  80.  like a book.  An example is that this software may be used by any number
  81.  of people and may be freely moved from one computer location to another,
  82.  so long as there is no possibility of it being used at one location
  83.  while it's being used at another.  Just as a book cannot be read by two
  84.  different persons at the same time. Site-License arrangements may be
  85.  made by contacting the author.
  86.  
  87.  You are encouraged to pass a copy of 'The Glide' along to your friends
  88.  for evaluation (see the list of Glide System files below).  Please
  89.  encourage them to register their copy if they find that they can use it.
  90.  All registered users will receive a copy of the latest version of the
  91.  'The Glide' system and any utilities for 'The Glide' that are available
  92.  at the time of registration. Registered users will also get support on
  93.  Delphi by leaving E-mail to POWELLR@Delphi.Com, or by postal mail sent
  94.  to the address on the registration form.
  95.  
  96.  About "The Glide"
  97.  ==================
  98.  The Glide is designed to provide an Integrated Development Environment
  99.  (IDE) that is fully configurable, allowing you, the programmer, to
  100.  develop programs in any language, and use any tool you currently have
  101.  within a consistent, stable, and easy to use interface shell.
  102.  Features
  103.  --------
  104.  All Aspects Completely Configurable.
  105.  Menu driven and Mousable with Complete Internal Help System.
  106.  Internal file Viewer supports:
  107.         Text, *.DBF, *.LZH, Compressed Glide Projects (*.GLA), *.PCX
  108.  Swap to Expanded memory, High memory, or Disk.
  109.  Supports 25, 43, or 50 column screen modes.
  110.  Globally Find and Replace Character Strings throughout multiple files.
  111.  Define up to 6 Tools / Utilities with each Language Environment.
  112.  Internal or External Screen Saver.
  113.  Internal On-Screen Clock, pop-up Calculator, and Calendar.
  114.  Print files with user Defined Printer Initialization and Reset Strings.
  115.  Execute DOS Commands or Completely Shell out to DOS
  116.  Setup DOS Environment Variable(s) for each Language Environment or Project
  117.  Creates your Make and Link utility Script files for you.
  118.     Currently supported script formats include:
  119.     RMake, RTLink, RTLink Overlayed, MS-Link, Blinker, Blinker Overlayed
  120.  Remembers and reloads your last project.
  121.  Archive/Unarchive all project files ( Registered users only ).
  122.  
  123.  Glide System Files
  124. -------------------
  125.  If all of the following files are not included with your copy of 'The
  126.  Glide'.  Please do not use it.  It may be corrupt, and at best
  127.  unpredictable results may occur.
  128.  
  129.                  File Name              File Description
  130.                 ------------------     ------------------
  131.  drive:\glide\+- glide.exe             Glide System Loader
  132.               |  glide-x.exe           Main Glide Executable
  133.               |  glide1.pcx            Glide Opening Screen
  134.               |  glide2.pcx              "      "       "
  135.               |  glide.dbf             Glide Loader Information Data file                                                                                                                                                                    
  136.               |  glide.dbt               "      "       "        "    "
  137.               |  glide.cfg             Glide Configuration File
  138.               |  glide.ico             Windows Icon for 'The Glide'
  139.               |  glide.pif             Windows Program Information file
  140.               |  glide.doc             Glide External Documentation file
  141.               |  readme.doc            Glide Quick Documentation
  142.               |  twhelp.dbf            Glide Internal Help Data
  143.               |  twhelp.dbt              "      "       "   "
  144.               |  twhelp1.ntx             "      "       "   "
  145.               |  invoice.doc           Glide invoice / order form
  146.               |  shr-ware.doc          What is Shareware ?  Documentation
  147.               |  revision.doc          Glide revision information file
  148.               +- \env\clipper.env      Clipper Sample Environment file
  149.               |       msc.env          Microsoft C/C++     "       "
  150.               +- \gfr\gfr.doc          Global Find & Replace - Documentation
  151.               |       gfr.exe          Global Find & Replace - Executable
  152.               +- \lha\history.eng      LHA Compression - History File
  153.                       lha.exe          LHA Compression - Executable File
  154.                       lha.hlp          LHA Compression - Help File
  155.                       lha213.doc       LHA Compression - Documentation File
  156.  
  157.  Starting the The Glide
  158. -----------------------
  159.  The easiest way to run the Glide, is to put the glide directory in your
  160.  DOS path, and just type: GLIDE [RETURN].  This however, is not strictly
  161.  necessary, you may call the glide without it being in your path, by
  162.  simply using the entire drive, directory and filename.  Such as,
  163.  "C:\GLIDE\GLIDE [RETURN]".  This method will work just as well.
  164.  
  165.  The Glide will accept a parameter of /P=<PROJECT NAME>, which will force
  166.  it to load the specified project.  If you do not pass it a project
  167.  parameter, it will attemp to load the last project that you worked on.
  168.  
  169.  General Operation Information
  170. ===============================
  171.  The Glide allows you to define information about nearly all aspects of
  172.  a programming task.  First, you need to define information about the
  173.  particular language that you are using and its associated programs.
  174.  Such as, the Language compiler executable, link utility, make utility,
  175.  etc.  This information, I have termed as your operating environment or
  176.  simply your environment.
  177.  
  178.         Next, you need to define the information that is associated with
  179.  a particular project.  This includes such things as your master source
  180.  file, secondary support source files, object files, libraries, data
  181.  files, etc.
  182.  
  183.         Once this information has been defined,  everything that you
  184.  need to do when developing a program is right at your finger tips. You
  185.  can edit your source code, the Glide will generate generic make and
  186.  link scripts for you which you can use directly or modify to suite your
  187.  purposes.  You can compile and link your code and the Glide will inform
  188.  you if there was errors by monitoring the errorlevel returned by your
  189.  compiler, linker, or make utility.  You can run your debugger, to find
  190.  all those nasty little errors ( but I guess you won't really need that,
  191.  because you never write code with bugs in it, do you ?  :-).  You can
  192.  run your project, and when everything is complete you can archive all
  193.  of its associated files into an LHA Compressed format and store them
  194.  safely out of harms way.  If you ever need to modify it,  you can
  195.  simply unarchive the project and it will recreate all your files
  196.  exactly the way they were including the directory structure.
  197.  
  198.  The Glide will swap itself out of Base memory to whenever it need to run
  199.  another program leaving only about 12k of itself resident.  You may
  200.  configure the Glide to swap to either Expanded memory, High memory, or
  201.  disk depending upon your needs.
  202.  
  203. Basic Overview of Menu Options
  204. ------------------------------
  205.  
  206.  File - The "FILE" Menu provides you with Global Services and Setup
  207.         Options.
  208.  
  209.  File Menu Options
  210.  
  211. > Open        - Open and View a dBase, LHA Compressed Project, Standard
  212.                 Text File, or PCX Graphics file in an internal window.
  213.                         Currently supported PCX Formats include:
  214.                               VGA 320 x 200 x 256
  215.                               VGA 640 x 480 x 16
  216.                               EGA 640 x 350 x 16
  217.  
  218.                 (PCX Files must be less than or equal to 64k in size)
  219.  
  220. > Global Find - GFR is a freeware utility that when given a file spec,
  221.   & Replace     will search and replace all occurrences of a particular string
  222.                 within all files that match the specification.
  223.  
  224. > Execute     - Run a single DOS Command.
  225.  
  226. > DOS Shell   - Exit to DOS to Run multiple commands.
  227.  
  228. > Setup       - Provides access to the Global and Environment setups,
  229.                 Utilities, Default Colors.
  230.  
  231. > Register    - What is Shareware? Print an invoice. Enter Registration               
  232.               number.
  233.  
  234. > Exit        - Quit "The Glide"
  235.  
  236.  Edit Menu Options
  237.  
  238.     The "EDIT" Menu enables you to use your preferred editor to
  239.     edit several predefined project work files or project support
  240.     files or to enter a filename of your choice to edit.
  241.  
  242.  Project Menu Options
  243.  
  244.     The "PROJECT" Menu allows you to load, edit, save, and erase
  245.     pertinent information about a particular project.  Once this
  246.     information has been entered, the internal glide Script Creation
  247.     utility will automatically create your make file in a RMake
  248.     Style format, and your Linker script file in a RTLink/Plink,
  249.     BLINKER, or Microsoft Link style format depending upon which one of
  250.     them is selected in the project setup information.
  251.  
  252.     If you select the overlayed option for your link script, the Glide will
  253.     create a script that attempt to overlay all project support files,
  254.     objects, and library files.  If you do not wish this to happen then you
  255.     should select the non-overlayed option or edit and change the overlayed
  256.     script to you liking.
  257.  
  258.     * NOTE *  Library files defined in the environment setup will not be
  259.               overlayed.
  260.  
  261.  Language Menu Options
  262.  
  263.     The Language menu allows you to shell out and compile, link
  264.     or make the program source code that have been setup in your
  265.     project.
  266.  
  267.  Debug Menu Options
  268.  
  269.     The "Debug" option shells out and runs your Debug utility with the
  270.     name of your executable output file. You must have compiled and
  271.     linked your application with the correct parameters specifying you
  272.     want debug information included in the applications executable.
  273.  
  274.  Run Menu Option
  275.  
  276.     The "RUN" Option will Shell out and run the Output executable
  277.     file specified in your project setup.
  278.  
  279.  Tools Menu
  280.  
  281.     Each Glide Environment file has an associated utility file that you
  282.     may define up to 6 of your own utilities, and have them selectable
  283.     from the Tools menu.  The "Tools" Menu is a dynamically changing
  284.     menu.  This menu will change every time you change the utility setup
  285.     information within the File setup menu.
  286.  
  287.  
  288. Glide Environment Setup
  289. -----------------------
  290.  Compiler Executable and Parameters - These fields define the name of
  291.  your Compiler executable and the associated parameters that will be
  292.  setup every time you load "The Glide".  DO NOT put in any program
  293.  source code names, they will be setup within the project information
  294.  section of "The Glide".  You may also use the browse button to select
  295.  a file.
  296.  
  297.  Linker Executable and Parameters - These fields define the name of
  298.  your Linker executable and the associated parameters, that will be
  299.  set up every time you load "The Glide".  As with the Compiler, DO NOT
  300.  enter any source code filenames here.
  301.  
  302.  Make Executable and Parameters     - Same as above.
  303.  Debugger Executable and parameters - Same as above.
  304.  Editor Executable and parameters   - Same as above.
  305.  
  306.  Standard Libraries - Enter your default libraries or any libraries
  307.  that cannot be dynamically overlayed.  These libraries will be linked
  308.  in at the root level during the linking process if you use the Make
  309.  and Link script files created by the Glide.  ( Use the spacebar to
  310.  mark your selected files.  They need not all be in the same directory
  311.  as your master source file. )
  312.  
  313. Global Utilities Setup
  314. ----------------------
  315.  You may add up to six executable utilities to the glide menu system.
  316.  They will appear within the "Tools" sub menu after they are defined
  317.  in the utilities setup section.
  318.  
  319.  Menu Prompt - Enter in an 8 character prompt that will display under
  320.  the "Tools" section of the main menu for this utility.
  321.  
  322.  Utility Description - Enter an extended description of the Utility
  323.  you are adding.  This description may be up to 78 character long.
  324.  
  325.  Executable Filename - Use the Alt-E keys to pull up a file selection
  326.  screen, from there select the executable filename of any program
  327.  you would like to add to the system.
  328.  
  329.  Utility Parameters - Enter any parameters that will be needed for this
  330.  utility to operate properly.  This field will also accept a predefined
  331.  set of macros that when called will translate into project information.
  332.  The macros are defined below:
  333.  
  334.      /master  =>  Master source file name
  335.      /support =>  Comma delimited list of support files
  336.      /objs    =>  Comma delimited list of object files
  337.      /libs    =>  Comma delimited list of Library files
  338.      /cs      =>  Compiler script name
  339.      /ms      =>  Make script name
  340.      /ls      =>  Link script name
  341.      /exe     =>  Executable output filename
  342.      /cp      =>  Compiler parameters
  343.      /lp      =>  Link parameters
  344.      /mp      =>  Make parameters
  345.      /dp      =>  Debugger parameters
  346.      /ep      =>  Editor parameters
  347.      /?       =>  Pop up a box and allow you to enter parameters at
  348.                   runtime
  349.  
  350. Glide Color Setup
  351. -----------------
  352.  This option will allow you to configure the appearance of the Glide
  353.  system.  You may select any and all system colors through this
  354.  process.
  355.  
  356. Glide Project Setup
  357. -------------------
  358.  Workfile #1 - This is the primary program file you are working on.  If
  359.  it is not in the default directory you must specify a full path name or
  360.  use the browse button to select a file.
  361.  
  362.  Project Support file(s) - These are secondary program file(s) that will
  363.  be compiled and linked to create the final project executable.  ( Use
  364.  the spacebar to mark your selected files.  They need not all be in the
  365.  same directory as your master source file. )
  366.  
  367. ( Project Setup Continued )
  368.  
  369.  Object Files - Enter all object files (*.OBJ) that need to be
  370.  linked into your application. ( Use the spacebar to mark your selected
  371.  files.  They need not all be in the same directory as your master
  372.  source file. )
  373.  
  374.  Library files - Enter your project specific Library files for this
  375.  application.  They must be able to be overlayed if you are going to
  376.  use the Overlayed scripts created by 'The Glide'. If they cannot be
  377.  overlayed you must put them in the Standard libraries section of the
  378.  Environment setup screen.  ( Use the spacebar to mark your selected
  379.  files.  They need not all be in the same directory as your master
  380.  source file. )
  381.  
  382.  Supporting Data Files - Select any other file(s) that needs to be
  383.  included with this particular project.  These could include Database
  384.  files, index files, documentation files, Icons, PCX Files, etc.
  385.  Virtually any file can be linked with the project, and therefore,
  386.  included in the projects archive file.  ( Do not include project
  387.  script files, they are included by default. )  ( Use the spacebar to
  388.  mark your selected files.  They need not all be in the same directory
  389.  as your master source file. )
  390.  
  391.  Project Environment - Select the language environment to be used for
  392.  this project.
  393.  
  394.  Link Script Style - Define in what format you want the Link script to
  395.  be created.  The choices are: RTLink, RTLink Overlayed, Blinker,
  396.  Blinker Overlayed, and Microsoft Link.
  397.  
  398.  Project Information - Enter descriptive information about this project.
  399.  The project name and creation date are include automatically.  You may
  400.  enter a version number, and an extended description of the project.
  401.  
  402.  Project Specific Parameters -  This is were you may enter project
  403.  specific parameters for your compiler, linker, make utility, etc.
  404.  These should be parameters that you normally don't use but are
  405.  required for this application or are temporary in nature.
  406.  
  407. Glide Internal Script Generator
  408. -------------------------------
  409.  This is a feature that will automate the creation of Link and Make
  410.  utility script files for the your  compiler and its associated Link
  411.  and Make utility programs.  These scripts are fairly general in nature
  412.  in that they will definitely work with the following utilities: RMake,
  413.  RTLink, Blinker, and Microsoft Link. If you are using something else,
  414.  you should be able to modify them to work with your utility fairly
  415.  easily.  The scripts will use all the information in the Environment
  416.  and project setup files, including all defined parameters for your
  417.  Compiler, and Link utilities.
  418.  
  419.  
  420. ( Glide Internal Script Generator Continued )
  421.  
  422.  The make file will use your selected compiler in its script to create
  423.  the object files for your application. The link script will be
  424.  created to conform to style that you select ( RTLink, Blinker, or
  425.  Microsoft Link ).  You may also tell the script generator whether or not
  426.  you want a script that will allow your code to be overlayed.  If you
  427.  select the overlayed option, all supporting source, object, and library
  428.  files will be overlayed.
  429.  
  430.  -*- NOTE -*-
  431.  
  432.  If you have a library that dictates that it may not be overlayed, you
  433.  may define it in the Environment setup ( Standard Libraries ), any
  434.  libraries defined here will be linked in at the root and will not be
  435.  overlayed.
  436.  
  437. Windows Usage
  438. -------------
  439.  I have provided a Windows PIF file, and a Windows Icon that you may use
  440.  to call the Glide from within the Windows Environment. I personally
  441.  have not had a whole lot of luck with them, it seems that the Glide
  442.  wants more than windows is willing to give, but you may use them if you
  443.  like.
  444.  
  445. Future Enhancements
  446. -------------------
  447.  In the future, some of the things that I would like to see happen to the
  448.  Glide are:
  449.  
  450.     Support for Microsoft's NMake Program Make Utility Scripts.
  451.     Support for WarpLink Scripts.
  452.     Ability to get a Print out of your Project and Environment setups.
  453.     Support for all PCX File types and sizes.
  454.     Maybe Some sort of Version Control System.
  455.  
  456. I am also open for suggestions from registered users.  Just jot some
  457. things down in the comments section of the Registration Invoice, and I
  458. will see what I can do.
  459.  
  460. Acknowledgments
  461. ---------------
  462.         I would personally like to thank and acknowledge the following
  463. people for their efforts and generosity in providing the following
  464. quality software to the general public as freeware.  I have incorporated
  465. there programs into my own, and feel they deserve some of the credit as
  466. well.
  467.  
  468. LHA Compression Software, Version 2.13
  469.   Copyright 1991, Haruyasu Yoshizaka
  470.  
  471. GMUtant Find & Replace, Version 1.00
  472.   Copyright 1992, Clyde W. Grotophorst
  473.  
  474.         I would also like to thank the following software vendors for
  475. providing quality programming languages and environments, without which,
  476. this program would have never come into existence.
  477.  
  478. Microsoft C/C++ (R), Versions 7 & 8
  479.   Copyright 1992-1993, Microsoft Corporation
  480.  
  481. Microsoft Segmented Executable Linker (R), Version 5.5
  482.   Copyright 1984-1993, Microsoft Corporation
  483.  
  484. Microsoft Windows (R), Version 3.1
  485.   Copyright 1985-1992, Microsoft Corporation
  486.  
  487. Clipper (R), Versions 5.01a
  488.   Copyright 1985-1992, Computer Associates International, Inc.
  489.  
  490. RMake, Version 1.3
  491.   Copyright 1989-1992, Computer Associates International, Inc.
  492.  
  493. RTLink, Version 3
  494.   Copyright 1988-1991, Pocket Soft Inc.
  495.  
  496. Blinker, Version 2.0
  497.   Copyright 1991, Blink, Inc.
  498.  
  499.  
  500.                               'The Glide'
  501.                             Version #1.00.02
  502.  
  503.                               REGISTRATION
  504.  
  505.       Quan       Item                                           Cost
  506.  
  507.       ___  'The Glide' Registration............. @ $49.00 ea $________
  508.             (includes registration + program)
  509.  
  510.                          Shipping & Handling (Quan x $3.00)  $________
  511.  
  512.            Illinois residents please add 6.5% PST.      Tax  $________
  513.  
  514.                                                       Total  $________
  515.  
  516.              Check disk size required:  __ 5 1/4  __ 3 1/2
  517.  
  518.                         Checks or money orders accepted.
  519.       -----------------------------------------------------------------
  520.  
  521.           Name_______________________________________________________
  522.  
  523.        Company_______________________________________________________
  524.  
  525.        Address_______________________________________________________
  526.  
  527.               _______________________________________________________
  528.  
  529.          Phone_________________________  Bus.________________________
  530.  
  531.       Where did you obtain 'The Glide'?
  532.  
  533.               _______________________________________________________
  534.  
  535.       What Programming Languages are you using 'The Glide' with ?
  536.  
  537.               _______________________________________________________
  538.  
  539.               _______________________________________________________
  540.  
  541.       Comments_______________________________________________________
  542.  
  543.               _______________________________________________________
  544.  
  545.               _______________________________________________________
  546.  
  547.       -----------------------------------------------------------------
  548.       MAKE PAYMENT TO:  Russell A. Powell
  549.                         708 Gawain
  550.                         Troy, Illinois, U.S.A.
  551.                         62294
  552.  
  553.  
  554.